Summary

• add a small app.tools package as the first deterministic agent-tool surface
• add tool-level schemas (ToolPOI, RouteStop, RouteSortResult, RouteSortWarning)
• support Chinese/English stop-role normalization through normalize_stop_role
• sort same-day attractions with nearest-neighbor routing while keeping meal/hotel roles on a day backbone
• return structured warnings with severity so a future harness can decide whether to continue, degrade, or retry

Notes

• This tool is offline and deterministic: it does not call an LLM, AMap, or any paid API.
• It does not assign meal times. Callers should provide breakfast/lunch/dinner roles explicitly.
• category=play and category=stay can be used as low-severity role fallback; category=eat is intentionally not guessed as a specific meal slot.
• The existing workflow is not wired to this tool yet, so current product behavior remains unchanged.

Validation

• uv run pytest tests/test_route_sort_day_tool.py -> 8 passed
• uv run pytest -> 63 passed